home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_hylafax.idb / usr / freeware / man / cat1 / pagesend.Z / pagesend
Encoding:
Text File  |  1999-07-16  |  5.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. PPPPAAAAGGGGEEEESSSSEEEENNNNDDDD((((1111MMMM))))     UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOccccttttoooobbbbeeeerrrr 3333,,,, 1111999999995555))))     PPPPAAAAGGGGEEEESSSSEEEENNNNDDDD((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      pagesend - _H_y_l_a_F_A_X IXO/TAP and UCP transmit program
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////ffffrrrreeeeeeeewwwwaaaarrrreeee////ssssbbbbiiiinnnn////ppppaaaaggggeeeesssseeeennnndddd [ ----llll ] [ ----pppp ] [ ----cccc _c_o_n_f_i_g ] ----mmmm
  13.      _d_e_v_i_c_e-_I_D _q_f_i_l_e
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _p_a_g_e_s_e_n_d is the program that implements the IXO/TAP and the
  17.      UCP transmission protocol for the _H_y_l_a_F_A_X system.  _p_a_g_e_s_e_n_d
  18.      is invoked by the _f_a_x_q scheduler process for each pager
  19.      transmit attempt.  _p_a_g_e_s_e_n_d assumes that its current working
  20.      directory is the top of the spooling hierarchy and that a
  21.      suitable modem device has been allocated for its use.  In
  22.      normal use _p_a_g_e_s_e_n_d will inherit a lockfile for the modem
  23.      from the _f_a_x_q process.  The format of the job description
  24.      file specified on the command line is described in
  25.      _s_e_n_d_q(4F).
  26.  
  27.      _p_a_g_e_s_e_n_d initializes the modem before attempting to transmit
  28.      the pager message using the information in the appropriate
  29.      modem configuration file.  If the modem does not respond to
  30.      this initialization, _p_a_g_e_s_e_n_d will repeatedly try to
  31.      initialize the modem.  This behaviour is required for send-
  32.      only environments in which a _f_a_x_g_e_t_t_y(1M) process is not run
  33.      (and the modem would be known to be in a properly
  34.      initialized state).  _p_a_g_e_s_e_n_d catches SIGINT and SIGTERM and
  35.      cleans up any resources it controls; this is the mechanism
  36.      used by _f_a_x_q to abort a job while it is in progress.
  37.  
  38.      Many aspects of _p_a_g_e_s_e_n_d operation are controlled through a
  39.      configuration file.  The configuration file is located in
  40.      the spooler hierarchy in the eeeettttcccc subdirectory and is named
  41.      ccccoooonnnnffffiiiigggg...._d_e_v_i_c_e-_I_D;;;; consult _c_o_n_f_i_g(4F) for detailed
  42.      information on the contents of configuration files.
  43.  
  44.      The protocol which must be used for a specific service
  45.      provider is controled from the _i_n_f_o(4F) file.
  46.  
  47. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  48.      ----cccc _c_o_n_f_i_g Treat _c_o_n_f_i_g as a configuration parameter
  49.                specification that is interpreted after reading
  50.                the per-device configuration file.  For example,
  51.                ``-c sessiontracing:0x4f'' would set the
  52.                SSSSeeeessssssssiiiioooonnnnTTTTrrrraaaacccciiiinnnngggg configuration parameter to
  53.                ``0x4f'', overriding any setting in the
  54.                configuration file.
  55.  
  56.      ----mmmm _d_e_v_I_D  The device to use in processing the job.  Note
  57.                that this is a _d_e_v_i_c_e _i_d_e_n_t_i_f_i_e_r and not the
  58.                pathname of the tty special file.  A device
  59.                identifier is formed from a device filename by
  60.  
  61.  
  62.  
  63. Page 1                                          (printed 6/24/99)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPAAAAGGGGEEEESSSSEEEENNNNDDDD((((1111MMMM))))     UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOccccttttoooobbbbeeeerrrr 3333,,,, 1111999999995555))))     PPPPAAAAGGGGEEEESSSSEEEENNNNDDDD((((1111MMMM))))
  71.  
  72.  
  73.  
  74.                removing any leading ``/dev/'' and converting any
  75.                ``/'' characters to ``_'' characters.
  76.  
  77.      ----llll        Do the UUCP lockfile protocol in _p_a_g_e_s_e_n_d.  By
  78.                default _p_a_g_e_s_e_n_d assumes that it is invoked with
  79.                the device already locked and that it does not
  80.                need to manage the lockfile.
  81.  
  82.      ----pppp        Do not change the process priority when
  83.                transmitting.  Normally _p_a_g_e_s_e_n_d will raise its
  84.                priority to reduce i/o latency.  This option is
  85.                useful for debugging.
  86.  
  87. NNNNOOOOTTTTEEEESSSS
  88.      _p_a_g_e_s_e_n_d returns the new job status to _f_a_x_q through the
  89.      _e_x_i_t(2) return value of the process:  _s_e_n_d__r_e_t_r_y (0), retry
  90.      job; _s_e_n_d__f_a_i_l_e_d (1), job finished without success,
  91.      _s_e_n_d__d_o_n_e (2), job completed successfully, _s_e_n_d__r_e_f_o_r_m_a_t
  92.      (3), job should be retried after documents are reformatted.
  93.  
  94. FFFFIIIILLLLEEEESSSS
  95.      /usr/freeware/var/spool/fax/etc/config.devID device-specific
  96.      configuration file
  97.  
  98.      Consult _h_y_l_a_f_a_x(4F) for a complete discussion of the
  99.      structure and content of the spooling area.
  100.  
  101. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  102.      _f_a_x_q(1M), _h_y_l_a_f_a_x(4F), _c_o_n_f_i_g(4F), _i_n_f_o(4F)
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Page 2                                          (printed 6/24/99)
  130.  
  131.  
  132.  
  133.